kill cutility <= ie. a cute utility :-)
~~~~~~~~~~~~~

(c) Musus Umbra 1996

Permission is granted for unlimited personal use & modification.

Permission is granted for redistribution (by any method) provided that:
	No charge is made for this software.  A reasonable charge may be
		made for media / handling / etc. This software is *free*.
	Any distributed copy of this software must be unaltered and entire.
		You may not distribute modified / imcomplete copies of this
		software.  If you fix a bug / add a feature, let me know so
		that I can update the master copy.

As usual with freeware, there is no warranty of any kind.  The author cannot
be help responsible for any loss/damage arising from the use/inability to
use this software.  It is the user's responsibility to determine the fitness
of this software for any purpose they put it to.

(But if it doesn't work, I will try to help :-)


kill
~~~~

Kill is a simple utility that attempts to quit a specified application.  It
does this by starting up as a task itself, and then sending the target
application a 'Quit' message.

A (properly behaved) application will shut itself down upon receipt of this
message.  Note that the usual 'You have unsaved data...' sort of thing
*will not happen* with a properly behaved application.  Use with care.

NB: you can only use 'kill' in situations where it is valid to start a task!
Suitable places include:
	In an obey file that you double-click
	In the 'New Task' submenu from the task manager
	Using Wimp_StartTask from within a program
	At the CLI prompt in a taskwindow :-)
You cannot run 'kill' from (for example) the CLI prompt you get by pressing
f12.

Syntax:
	kill [-i|-c]  <taskname> [<taskname>...]

-i makes 'kill' treat the task name(s) given as case insensitive.
-c makes 'kill' treat them as case sennsitive.

Note that to specify a task name that contains a space, you must enclose
it in "s.  The task name(s) should be exactly as they are in the Task Manager's
'Tasks' window.

egs.
	kill -i "display manager" Spark
		quits the display manager & spark(plug).

	kill -c "display manager" Spark
		only quits spark(plug) - the -c makes the names case
		sensitive.

	kill -i frooble frooble frooble
		quit 3 'frooble's.  If there are four copies of 'frooble'
		running, there will be only one left running after this
		'kill'

	kill Alarm
		quit Alarm.


Contact:
	e-mail:		musus@argonet.co.uk
	WWW:		http://www.argonet.co.uk/users/musus/
	Snail:		c/o 23 Baronsway, Whitkirk, Leeds, LS15 7AW, ENGLAND.
